home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / earcd / misc / emu / gbuk.lha / readme.ami < prev   
Text File  |  1997-01-30  |  12KB  |  276 lines
  1. ********************************************************
  2. *                                                      *                    
  3. *                   GBUK VERSION 1.01                  *
  4. *                   30th January 1997                  *
  5. *                                                      *                    
  6. ********************************************************
  7.                             
  8.                        WHAT IS IT?
  9.                             
  10. It  is  a gameboy emulator that works on an Amiga with  a
  11. 68020+  processor and 256 color graphics. It is based  on
  12. the  Unix emulation written by Marat Fayzullin. The  game
  13. carts are loaded off of files which are themselves memory
  14. dumps of gameboy carts.
  15.  
  16.                        INSTALLING
  17.                             
  18. To  install the program, all you do is create a directory
  19. on  your hard drive, say dh0:gb, then extract the archive
  20. into  that directory. To run the program you now  open  a
  21. CLI  window,  set the current directory to  the  one  you
  22. extracted the archive to and type GBUK.
  23.  
  24.                     USING THE PROGRAM
  25.                             
  26. When you first run the emulator, after a short pause  you
  27. should  come  to a screen where you can choose  the  game
  28. cart  that you want to load. Hopefully, the operation  of
  29. this bit should be straight forward. If it's not, see the
  30. explanation below under LOAD.
  31.  
  32. Once  you have selected a valid cart you will be  in  the
  33. game  proper.  From here you can control everything  just
  34. like  on  a normal gameboy. The keyboard equivalents  for
  35. the buttons and joypad on the gameboy are as follows:
  36.  
  37.           +-----------------+------------+
  38.            | Gameboy         |  Keyboard  | 
  39.            |                 | equivalent |
  40.            +-----------------+------------+                 
  41.            | Right on joypad |    6 on    |
  42.            |                 |  numerical |
  43.            |                 |   keypad   |
  44.            +-----------------+------------+
  45.            | Left on joypad  |    4 on    |
  46.            |                 |  numerical |
  47.            |                 |   keypad   |
  48.            +-----------------+------------+
  49.            |  Up on joypad   |    8 on    |
  50.            |  joypad         |  numerical |
  51.            |                 |   keypad   |
  52.            +-----------------+------------+
  53.            | Down on joypad  |    2 on    | 
  54.            |  joypad         |  numerical |
  55.            |                 |   keypad   |
  56.            +-----------------+------------+
  57.            | A button        | Left shift |
  58.            |                 |            |
  59.            +-----------------+------------+
  60.            | B button        |    Tab     |
  61.            |                 |            |
  62.            +-----------------+------------+
  63.            |  Select         |  Left Alt  |
  64.            |                 |            | 
  65.            +-----------------+------------+
  66.            |  Start          |  Control   |
  67.            +-----------------+------------+     
  68.  
  69. If  you  like,  you  can change these options  using  the
  70. Keyboard preferences described below under KEYS.
  71.  
  72. If  you  want to access the main game menu at  any  time,
  73. then  you  just  press F2 or else press the  right  mouse
  74. button.   The   currently  selected  option   is   always
  75. highlighted  in red. To change the current option  either
  76. click  on the option you want with the mouse or else  use
  77. Up  and down on the keyboard (the keys that correspond to
  78. up  and  down  on the gameboy). To go to the  option  you
  79. selected, press enter or else double click on it with the
  80. mouse  button. Here is a description of what the  various
  81. options do.
  82.  
  83. LOAD:  This  brings up a file requester allowing  you  to
  84. choose the name of the cart you want to load. It works in
  85. the following way. On the left of the screen is a list of
  86. files  and  directories. The files are in black  and  the
  87. directories in red. If you can see the name of  the  file
  88. you  want to load, just double click on it with the mouse
  89. pointer.  If you don't see the name of the file then  you
  90. can  scroll  down the list using the up and down  buttons
  91. and  the  scroll bar. If you still don't see the name  of
  92. the  file  you  want  then  you  can  change  to  another
  93. directory  by  double clicking on one  of  the  directory
  94. names  or  else  you  can go back a  directory  level  by
  95. clicking on parent. If you want to examine another  drive
  96. attached  to your computer then you click on  the  button
  97. VOLUMES  and a list of possible drives for you to  choose
  98. from  will be shown. If you would rather type in the name
  99. of  the file than scan down a long list of files then you
  100. can  do  so  by clicking on the long oblong  box  at  the
  101. bottom  of the screen with you mouse and then just typing
  102. in the name of the file followed by return.
  103.  
  104. If  the  file you selected doesn't exist or else isn't  a
  105. gameboy  file, you will be told so with an error  message
  106. and  then returned to the file selection screen.  If  you
  107. want to abandon this part, then you click on CANCEL.
  108.  
  109. PALETTE: This lets you choose the actual colors that  are
  110. used  on  the  gameboy  screen. So that  you  can  better
  111. understand  what this bit does, I will first explain  how
  112. the gameboy palette is organised.
  113.  
  114. The palette on the gameboy is split into four parts, each
  115. having  four colors. The first two parts are used by  the
  116. sprites.  The  third part is used by the background  (for
  117. example, it might be used for the hill and clouds in  the
  118. distance  on a platform game) and the last part  is  used
  119. for what is called the window. The window is usually used
  120. for  the  score line and stuff like that. Each  of  these
  121. sections  uses four colors. On the gameboy  itself  there
  122. are  only 4 colors from which each of these palettes  can
  123. be  chosen  from (4 shades of grey). On the emulator  you
  124. can set the colors to any of the colors of the rainbow.
  125.  
  126. To changed a color, you first of all click on the box for
  127. the color you want to change and then use the sliders  on
  128. the  bottom right of the screen to change the  amount  of
  129. red, green and blue in it. So that you can see the effect
  130. that  your  changes  are having, a copy  of  the  current
  131. gameboy display is shown on the left side of the screen.
  132.  
  133. Once you are happy with your changes you click on OK.  To
  134. cancel your changes, click CANCEL, this will restore  the
  135. colors as they were.
  136.  
  137. KEYS: This option lets you change the equivalence between
  138. buttons  on  the keyboard and buttons on the gameboy.  On
  139. the  left of the screen you see written the name  of  the
  140. buttons  on  the gameboy. On the right you see  what  the
  141. keyboard  equivalents for these are on the  emulator.  To
  142. change  an option you just click on the one you to change
  143. with  the mouse. It should now be highlighted in red.  To
  144. change it press return followed by the key you want. Once
  145. you are happy with your selections you just press okay to
  146. accept them and return to the game. If you messed up then
  147. CANCEL will return you to the game but no changes will be
  148. made.
  149.  
  150. SAVE: This takes a snapshot of your current game position
  151. and  saves it to disk so that you can load it back  again
  152. later.  You  select the file name through a  panel  which
  153. works  exactly the same way as the one used for selecting
  154. a  cart  to load. See above for an explanation of how  it
  155. works.
  156.  
  157. GRAB: This lets you save the current gameboy screen as  a
  158. picture file. You select the file name as described above
  159. under  saving games. The picture is saved as an  LBM  (as
  160. used by deluxe paint).
  161.  
  162. QUIT: Abandons the game and returns you to DOS.
  163.  
  164. CANCEL:  Abandons the menu and returns you  to  the  game
  165. where you left off.
  166.  
  167.                   CHANGING PREFERENCES
  168.                             
  169. All  the preferences for the program are contained within
  170. the file PREFS in the same directory as the main program.
  171. This  file  is  basically just  a  text  file  with  each
  172. preference set in the following way:
  173.  
  174. VARIABLE=VALUE
  175.  
  176. Each of these variables control something to do with  the
  177. program. For example this line:
  178.  
  179. FONT_GFX="GFX/TOPAZ11.PIC"
  180.  
  181. Says  that the graphics for the font can be found in  the
  182. file GFX/TOPAZ11.PIC. From this I hope you can see how it
  183. works. Most of the preferences you will actually want  to
  184. change  can be set in the program itself by going to  the
  185. palette  options and keyboard options. One  variable  you
  186. might  want to set yourself though is the one controlling
  187. the speed of the emulation. The name of this variable  is
  188. SLOW_DOWN  and  basically, the bigger the  value  is  the
  189. slower  the emulation. Its value can be anything  greater
  190. or equal to zero.
  191.  
  192. Another variable you might want to change is METHOD. This
  193. variable  effects the accuracy and speed with  which  the
  194. gameboy's  graphics are emulated. If  method=1  then  the
  195. graphics  are  inaccurate but quick and if method=2,  the
  196. graphics  are  more accurate but slower. The  main  thing
  197. that  goes wrong when using method=1 is that the  palette
  198. will  go  wrong slightly sometimes but for most  carts  I
  199. have tried its all right.
  200.  
  201.                 GETTING THE FULL VERSION
  202.                             
  203. This  version is only a demo. It has all the features  of
  204. the  full  version except that it has a ten  minute  time
  205. limit  on  its  use. That is you can keep  reloading  and
  206. playing  10  minutes  at  a  time,  but  you  can't  play
  207. continually.
  208.  
  209. To register for the full version, print off the following
  210. form,  fill it in and send it off to me together  with  a
  211. cheque  for 10 UK pounds. If you live outside of  the  UK
  212. but  in europe then you can send me a euro cheque. If you
  213. live  elsewhere then you order it by sending me a bankers
  214. cheque for this amount in UK funds.
  215.  
  216. If  you don't have access to a printer just write out the
  217. form on a bit of paper and then fill it in.
  218.  
  219. ---------------------------------------------------------
  220.  
  221. First Name: _________________ Last Name:_________________ 
  222.  
  223. Phone:___________________________________________________
  224.  
  225. Mailing Address:_________________________________________
  226.  
  227. _________________________________________________________
  228.  
  229. _________________________________________________________
  230.  
  231. E-Mail address___________________________________________
  232.  
  233.  
  234. How do you want me to send it to you?
  235. ( )E-Mail
  236. ( )Post
  237.  
  238. Which version do you want?
  239. ( ) PC (DOS)
  240. ( )Amiga (68020+ processor and AGA chip set)
  241.  
  242. ---------------------------------------------------------
  243.  
  244. You send this form to the following address:
  245.  
  246.                         Paul Gaze
  247.                       9 Larch Close
  248.                        Kingsworthy
  249.                        Winchester
  250.                    Hampshire SO23 7NE
  251.                          ENGLAND
  252.  
  253. Once you are registered I will send you any bug fixes for
  254. a year after the date that you registered.
  255.  
  256.                   WHAT DOESN'T WORK YET
  257.  
  258. The main thing that doesn't work at the moment is sound.
  259.  
  260.                       CONTACTING ME
  261.  
  262. If  you spot any bugs in the program and you want to tell
  263. me about them or for any other reason then you can e-mail
  264. me on pgaze@pgaze.demon.co.uk or else you can write to me
  265. via the normal post at:
  266.  
  267.                         Paul Gaze
  268.                       9 Larch Close
  269.                        Kingsworthy
  270.                        Winchester
  271.                    Hampshire SO23 7NE
  272.                          ENGLAND
  273.                             
  274. My web page is on http://www.pgaze.demon.co.uk.
  275.                             
  276.